home *** CD-ROM | disk | FTP | other *** search
/ Nightshift Sound & Vision / Nightshift - Sound & Vision.iso / gfxmanager / docs / ilbmtoppm.man < prev    next >
Text File  |  1995-04-13  |  6KB  |  265 lines
  1.  
  2.  
  3.  
  4.      ilbmtoppm(1)         AMIGA (25 October 1994)         ilbmtoppm(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           ilbmtoppm - convert an IFF-ILBM, IFF-RGBN, IFF-RGB8 or IFF-
  10.           PBM file into a portable pixmap
  11.  
  12.      SYNOPSIS
  13.           ilbmtoppm [-verbose] [-ignore chunkID]
  14.           [-isham|-isehb|-isdeep [-cmaponly] [-adjustcolors]
  15.           [-transparent color] [-maskfile filename] [ILBMfile]
  16.  
  17.  
  18.      DESCRIPTION
  19.           Reads an IFF-ILBM, IFF-RGBN, IFF-RGB8 or IFF-PBM file as
  20.           input.  Produces a portable pixmap as output.  Supported
  21.           ILBM types are:
  22.  
  23.           Normal ILBMs
  24.                1-8 planes with or without colormap, or 9-16 planes
  25.                with colormap.  If no colormap is present, ilbmtoppm
  26.                interprets the pixel values as intensity (grayscale)
  27.                values.  Amiga display modes Extra_Halfbrite (EHB) and
  28.                Hold-and-modify (HAM) are supported, and the
  29.                multiplatte formats Palette Change (PCHG chunk),
  30.                Dynamic HAM/Hires (CTBL chunk) and Sliced HAM (SHAM
  31.                chunk).  HAM images are limited to 3-10 planes.
  32.  
  33.           Deep ILBMs
  34.                9, 12 or 15 planes without colormap, or 18-48 planes
  35.                (the number of planes must be divisible by 3).  Most
  36.                deep ILBMs have 24 planes (for 8-bit RGB values).
  37.  
  38.           Direct color ILBMs
  39.                3-48 planes, no colormap, DCOL chunk.  This is an
  40.                experimental format that supports a different number of
  41.                planes for each color component.
  42.  
  43.           Colormap files
  44.                BMHD + CMAP chunk only, 0 planes.
  45.  
  46.           IFF-RGBN and IFF-RGB8 files
  47.                4 or 8-bit RGB values, genlock (transparency) bits
  48.                Compressed using a pixel repeat count. Uses the same
  49.                chunks as IFF-ILBM.
  50.  
  51.           IFF-PBM files
  52.                Uses chunky 8-bit pixels in the BODY chunk, otherwise
  53.                the same as colormapped IFF-ILBMs.
  54.  
  55.           Chunks used:
  56.                BMHD, CMAP, CMYK, CLUT, CAMG, DCOL, PCHG, CTBL, SHAM,
  57.                BODY
  58.  
  59.           Chunks ignored:
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/13/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      ilbmtoppm(1)         AMIGA (25 October 1994)         ilbmtoppm(1)
  71.  
  72.  
  73.  
  74.                GRAB, DEST, SPRT, CRNG, CCRT, DYCP, DPPV, DRNG, EPSF,
  75.                JUNK, CNAM, PRVW
  76.  
  77.           Other chunks (ignored but displayed in verbose mode):
  78.                ANNO, AUTH, (c), DPI, FVER, NAME, TEXT
  79.  
  80.           Unknown chunks are skipped.
  81.  
  82.      OPTIONS
  83.           Options marked with (*) can be prefixed with a "no", e.g.
  84.           '-noverbose'.  All options can be abbreviated to their
  85.           shortest unique prefix.
  86.  
  87.  
  88.           -verbose (*)
  89.                Give some information about the input file.
  90.  
  91.  
  92.           -ignore chunkID
  93.                Skip a chunk.  chunkID is the 4-letter IFF chunk
  94.                identifier of the chunk to be skipped.  This option can
  95.                appear more than once on the command line.
  96.  
  97.  
  98.           -isham | -isehb
  99.                Treat the input file as a HAM or EHB picture, even if
  100.                these flags or not set in the CAMG chunk (or if there
  101.                is no CAMG chunk).  This option has no effect with
  102.                RGBN/RGB8 and IFF-PBM pictures.
  103.  
  104.  
  105.           -isnotham | -isnotehb
  106.                Do not treat the input file as a HAM or EHB picture,
  107.                even if these flags are set in the CAMG chunk.  This
  108.                option has no effect with RGBN/RGB8 and IFF-PBM
  109.                pictures.
  110.  
  111.  
  112.           -isdeep
  113.                Treat an input file with less than 16 planes as a deep
  114.                ILBM, even if it provides a colormap. The number of
  115.                planes in the input file must be divisible by 3.  This
  116.                option has no effect with RGBN/RGB8 and IFF-PBM
  117.                pictures.
  118.  
  119.  
  120.           -isnotdeep
  121.                Do not treat an input file as a deep ILBM, even if it
  122.                has more than 8 planes and/or no colormap.  This option
  123.                has no effect with RGBN/RGB8 and IFF-PBM pictures.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/13/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      ilbmtoppm(1)         AMIGA (25 October 1994)         ilbmtoppm(1)
  137.  
  138.  
  139.  
  140.           -adjustcolors (*)
  141.                Scale a 4-bit colormap or shifted 4-bit colormap to 8
  142.                bits.  If this option is not used and ilbmtoppm
  143.                believes that the colormap consists of 4-bit values or
  144.                shifted 4-bit values, it prints a warning.  This option
  145.                has no effect with RGBN and RGB8 pictures.
  146.  
  147.  
  148.           -cmaponly
  149.                Extract only the colormap from the input file.  The
  150.                resulting PPM file will be in P3 ASCII format.  This
  151.                option results in an error if used with a RGBN or RGB8
  152.                file.
  153.  
  154.  
  155.           -transparent color
  156.                Write transparent pixels in color instead of their
  157.                colormap entry. The color is specified as in
  158.                ppmmake(1).
  159.  
  160.  
  161.           -maskfile filename
  162.                Generate a mask file from a mask plane (ILBM) or
  163.                transparent color entry (ILBM and IFF-PBM), or genlock
  164.                bits (RGBN/RGB8) and write it to filename. This is a
  165.                normal PBM image, the same size as the PPM output file.
  166.                A pixel value of PBM_WHITE in the mask file means the
  167.                corresponding in the output file is considered to be
  168.                transparent, PBM_BLACK indicates an opaque pixel (think
  169.                of the output file casting a shadow on a white screen).
  170.  
  171.  
  172.      BUGS
  173.           Lasso masks are not supported.  CLUT and CMYK chunk code is
  174.           untested.
  175.  
  176.  
  177.      REFERENCES
  178.           Amiga ROM Kernel Reference Manual - Devices (3rd Ed.),
  179.           Addison Wesley, ISBN 0-201-56775-X, Appendix A: Interchange
  180.           File Format
  181.  
  182.  
  183.      SEE ALSO
  184.           ppm(5), ppmtoilbm(1)
  185.  
  186.  
  187.      AUTHORS
  188.           Copyright (C) 1989 by Jef Poskanzer.
  189.           Modified 1993-1995 by Ingo Wilken
  190.           (Ingo.Wilken@informatik.uni-oldenburg.de)
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/13/95)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      ilbmtoppm(1)         AMIGA (25 October 1994)         ilbmtoppm(1)
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.      Page 4                                          (printed 4/13/95)
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.